.. _ocafilterparametric: 1.1.1.10 OcaFilterParametric ============================= Class Hierarchy: :ref:`OcaRoot ` :raw:html:`→` :ref:`OcaWorker ` :raw:html:`→` :ref:`OcaActuator ` :raw:html:`→` :ref:`OcaFilterParametric ` .. cpp:class:: OcaFilterParametric: OcaActuator A parametric equalizer section with various shape options. **Properties**: .. _ocafilterparametric_classid: .. cpp:member:: static const OcaClassID ClassID = "1.1.1.10" Number that uniquely identifies the class. Note that this differs from the object number, which identifies the instantiated object. This property is an override of the **OcaRoot** property. This property has id ``4.1``. .. _ocafilterparametric_classversion: .. cpp:member:: static const OcaClassVersionNumber ClassVersion = 2 Identifies the interface version of the class. Any change to the class definition leads to a higher class version. This property is an override of the **OcaRoot** property. This property has id ``4.2``. .. _ocafilterparametric_frequency: .. cpp:member:: OcaFrequency Frequency The frequency setpoint of the parametric filter. This property has id ``4.1``. .. _ocafilterparametric_shape: .. cpp:member:: OcaParametricEQShape Shape The shape of the parametric filter - peak, shelf, etc. This property has id ``4.2``. .. _ocafilterparametric_widthparameter: .. cpp:member:: OcaFloat32 WidthParameter Width parameter. For normal parametric implementations, this is the Q of the filter. This property has id ``4.3``. .. _ocafilterparametric_inbandgain: .. cpp:member:: OcaDB InbandGain In-band gain of the parametric filter. This property has id ``4.4``. .. _ocafilterparametric_shapeparameter: .. cpp:member:: OcaFloat32 ShapeParameter Width parameter. For certain filter types, this parameter may be used to represent extra information about the shape of the transfer function. This property has id ``4.5``. Properties inherited from :ref:`OcaWorker `: - :cpp:texpr:`OcaBoolean` :ref:`OcaWorker::Enabled ` - :cpp:texpr:`OcaList` :ref:`OcaWorker::Ports ` - :cpp:texpr:`OcaString` :ref:`OcaWorker::Label ` - :cpp:texpr:`OcaONo` :ref:`OcaWorker::Owner ` - :cpp:texpr:`OcaTimeInterval` :ref:`OcaWorker::Latency ` Properties inherited from :ref:`OcaRoot `: - :cpp:texpr:`OcaONo` :ref:`OcaRoot::ObjectNumber ` - :cpp:texpr:`OcaBoolean` :ref:`OcaRoot::Lockable ` - :cpp:texpr:`OcaString` :ref:`OcaRoot::Role ` **Methods**: .. _ocafilterparametric_getfrequency: .. cpp:function:: OcaStatus GetFrequency(OcaFrequency &Frequency, OcaFrequency &minFrequency, OcaFrequency &maxFrequency) Gets the equalizer frequency setpoint. The return value indicates whether the data was successfully retrieved. This method has id ``4.1``. :param OcaFrequency Frequency: Output parameter. :param OcaFrequency minFrequency: Output parameter. :param OcaFrequency maxFrequency: Output parameter. .. _ocafilterparametric_setfrequency: .. cpp:function:: OcaStatus SetFrequency(OcaFrequency Frequency) Sets the equalizer frequency. The return value indicates whether the value was successfully set. This method has id ``4.2``. :param OcaFrequency Frequency: Input parameter. .. _ocafilterparametric_getshape: .. cpp:function:: OcaStatus GetShape(OcaParametricEQShape &type) Gets the curve shape of the equalizer. The return value indicates whether the data was successfully retrieved. This method has id ``4.3``. :param OcaParametricEQShape type: Output parameter. .. _ocafilterparametric_setshape: .. cpp:function:: OcaStatus SetShape(OcaParametricEQShape type) Sets the curve shape shape of the equalizer. The return value indicates whether the shape was successfully set. This method has id ``4.4``. :param OcaParametricEQShape type: Input parameter. .. _ocafilterparametric_getwidthparameter: .. cpp:function:: OcaStatus GetWidthParameter(OcaFloat32 &Width, OcaFloat32 &minWidth, OcaFloat32 &maxWidth) Gets the width parameter property of the equalizer. The return value indicates whether the data was successfully retrieved. This method has id ``4.5``. :param OcaFloat32 Width: Output parameter. :param OcaFloat32 minWidth: Output parameter. :param OcaFloat32 maxWidth: Output parameter. .. _ocafilterparametric_setwidthparameter: .. cpp:function:: OcaStatus SetWidthParameter(OcaFloat32 Width) Sets the width parameter property of the equalizer. The return value indicates whether the Q was successfully set. This method has id ``4.6``. :param OcaFloat32 Width: Input parameter. .. _ocafilterparametric_getinbandgain: .. cpp:function:: OcaStatus GetInbandGain(OcaDB &gain, OcaDB &minGain, OcaDB &maxGain) Returns the in-band gain of the equalizer. The return value indicates whether the data was successfully retrieved. This method has id ``4.7``. :param OcaDB gain: Output parameter. :param OcaDB minGain: Output parameter. :param OcaDB maxGain: Output parameter. .. _ocafilterparametric_setinbandgain: .. cpp:function:: OcaStatus SetInbandGain(OcaDB gain) Sets the in-band gain of the equalizer. The return value indicates whether the gain was successfully set. This method has id ``4.8``. :param OcaDB gain: Input parameter. .. _ocafilterparametric_getshapeparameter: .. cpp:function:: OcaStatus GetShapeParameter(OcaFloat32 &shape, OcaFloat32 &minShape, OcaFloat32 &maxShape) Returns the shape parameter of the equalizer. The return value indicates whether the data was successfully retrieved. This method has id ``4.9``. :param OcaFloat32 shape: Output parameter. :param OcaFloat32 minShape: Output parameter. :param OcaFloat32 maxShape: Output parameter. .. _ocafilterparametric_setshapeparameter: .. cpp:function:: OcaStatus SetShapeParameter(OcaFloat32 shape) Sets the shape parameter of the equalizer. The return value indicates whether the parameter was successfully set. This method has id ``4.10``. :param OcaFloat32 shape: Input parameter. .. _ocafilterparametric_setmultiple: .. cpp:function:: OcaStatus SetMultiple(OcaParameterMask Mask, OcaFrequency Frequency, OcaParametricEQShape Shape, OcaFloat32 WidthParameter, OcaDB InBandGain, OcaFloat32 ShapeParameter) Sets some or all filter parameters. The return value indicates if the parameters were successfully set. The action of this method is atomic - if any of the value changes fails, none of the changes are made. This method has id ``4.11``. :param OcaParameterMask Mask: Input parameter. :param OcaFrequency Frequency: Input parameter. :param OcaParametricEQShape Shape: Input parameter. :param OcaFloat32 WidthParameter: Input parameter. :param OcaDB InBandGain: Input parameter. :param OcaFloat32 ShapeParameter: Input parameter. Methods inherited from :ref:`OcaWorker `: - :ref:`OcaWorker::GetEnabled(enabled) ` - :ref:`OcaWorker::SetEnabled(enabled) ` - :ref:`OcaWorker::AddPort(Label, Mode, ID) ` - :ref:`OcaWorker::DeletePort(ID) ` - :ref:`OcaWorker::GetPorts(OcaPorts) ` - :ref:`OcaWorker::GetPortName(PortID, Name) ` - :ref:`OcaWorker::SetPortName(PortID, Name) ` - :ref:`OcaWorker::GetLabel(label) ` - :ref:`OcaWorker::SetLabel(label) ` - :ref:`OcaWorker::GetOwner(owner) ` - :ref:`OcaWorker::GetLatency(latency) ` - :ref:`OcaWorker::SetLatency(latency) ` - :ref:`OcaWorker::GetPath(NamePath, ONoPath) ` Methods inherited from :ref:`OcaRoot `: - :ref:`OcaRoot::GetClassIdentification(ClassIdentification) ` - :ref:`OcaRoot::GetLockable(lockable) ` - :ref:`OcaRoot::LockTotal() ` - :ref:`OcaRoot::Unlock() ` - :ref:`OcaRoot::GetRole(Role) ` - :ref:`OcaRoot::LockReadonly() `